Skip to content

Conversation

@javiereguiluz
Copy link
Member

A minor change to be more precise about the actual behavior of the HTTP client.

Responses are always asynchronous, so that the call to the method returns
immediately instead of waiting to receive the response::
Symfony's HTTP client is asynchronous by default. When you call ``request()``,
the HTTP request starts immediately, but the method returns without waiting for
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
the HTTP request starts immediately, but the method returns without waiting for
the HTTP request might start immediately, but the method returns without waiting for

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But if we say "might start" ... then we need to explain when it starts and when it doesn't. Please, share some details about this. Thanks.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't know, curl does. We don't care here, that's the whole point

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In which scenarios would the request doesn't start immediatly?

E.g. if there's no network connection or if it's saturated? I guess that's expected and it's a temporary or permanent issue ... but not relevant to this explanation. The request starts immediately but if there's a huge issue you'll get an exception and if there's a small issue, there will be some delay.

So, let's go ahead with the originally proposed wording? Thanks.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It depends on the implementation for example. When using NativeHttpClient, it doesn't start immediately.
I'm fine keep as is, that's not critical either.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

OK, so let's merge this ... but of course we're open to change this in the future if we receive feedback from users thinking that the new description is not as precise as it should be 🙏 Thanks!

@javiereguiluz javiereguiluz added Waiting team decision Request for comments from Symfony Docs Team members and removed Waiting team decision Request for comments from Symfony Docs Team members labels Jan 5, 2026
@javiereguiluz javiereguiluz merged commit 5bfe308 into symfony:6.4 Jan 7, 2026
3 checks passed
@javiereguiluz javiereguiluz deleted the tweak_httpclient branch January 7, 2026 07:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants